Repository navigation
docs: refresh reviewed setup guide with Edge-first authentication - #102
Conversation
Refresh the public setup guide and generated Word copy, preserve compact Copilot instructions, separate feed authentication from genuine SSO, and protect private state without publishing consumer identifiers. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2c3cdb88-1ac5-4999-92e5-f546dfb0affd
|
FixLab CI failed and was contained without modifying source. Evidence is retained in the workflow artifacts: https://github.com/MonaDevAI/FixLab/actions/runs/41812769299 |
There was a problem hiding this comment.
🟡 Changes recommended
The paste-only prompt does not identify the setup guide’s location or provide a manual fallback, leaving fresh-checkout users without a way to find the installation and MCP instructions.
1 open issue
What changed in this PR
Refreshes FixLab’s guided setup documentation to default browser validation to Microsoft Edge, separate package-feed access from application SSO, and protect local authentication state. Standalone runtime defaults remain unchanged.
Changes:
- Expands setup guidance for feed authentication, dedicated Edge profiles, private-state protection, and dashboard verification.
- Clarifies approval requirements before first-run scaffolding and dashboard startup.
- Adds documentation assertions for Edge configuration, authentication safeguards, and onboarding order.
| File | Description |
|---|---|
test/documentation-policy.test.js |
Adds assertions for setup guidance and approval ordering. |
README.md |
Updates the compact setup prompt with Edge and authentication safeguards. |
installation.md |
Clarifies scaffolding approval and Edge configuration. |
docs/README.md |
Updates descriptions of the setup guides. |
docs/installation.md |
Aligns detailed installation instructions with reviewed Edge-first setup. |
docs/FIXLAB-SETUP.md |
Expands feed authentication, protected SSO, and readiness guidance. |
Review effort: Balanced
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7ecb4751-5093-4d69-919a-7bb8c124de11
|
FixLab CI failed and was contained without modifying source. Evidence is retained in the workflow artifacts: https://github.com/MonaDevAI/FixLab/actions/runs/41853077179 |
|
Updated in aad20d0: moved dashboard operation after Architecture, made setup/startup Copilot-first with questions for missing details, and consolidated dashboard use into one shorter six-step guide. Manual commands are fallback only. Validation: 4 documentation tests, docs check, formatting, diff check and packaging passed. Earlier lint, typecheck and policy checks passed. Full npm run validate reported linked-application test failures and was stopped; full unit and E2E validation are not complete. No runtime changes. |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 7ecb4751-5093-4d69-919a-7bb8c124de11
Problem
Fresh setup needs separate feed authentication, protected SSO state and explicit Edge selection.
Change
Refresh the setup guide and Word copy; keep README compact. Default guided browser setup to Edge, approve scaffolding first, and retain manual fallback. No new implementation skill warranted.
Validation
npm pack --dry-runincludes both guidesRisk
Documentation/assertions only; standalone runtime defaults unchanged. Application SSO and Word visual rendering not exercised. Full local Windows gate not repeated; merge requires successful GitHub checks.